ContentUpdated

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODLinkSource

ContentUpdated
The ContentUpdated method is called to notify this link-source object that its content has been updated.
void ContentUpdated (in ODUpdateID id,
                     in ODLinkKey key);
id
The update ID associated with the new content.
key
A valid link key obtained by a prior call to the Lock method.

DISCUSSION
If your part is the source part for this link-source object, you should call this method after writing the initial content to the content storage unit of this link-source object and after making changes to the content of that storage unit.
The id parameter identifies the new version of this link-source object's content; its value depends on the circumstance in which this method is called:

If you called the Clear method before calling this method, the id parameter should be the same update ID that you passed to the Clear method.
If your part originated the changes to its source content, the id parameter should be a new update ID that you to obtained by calling the UniqueUpdateID method of the session object.
If the changes occurred because the source content of this link contains the destination content of another link that was updated, the id parameter should be the update ID that your part received when it was notified to update the destination content within the source content for this link.

The key parameter ensures thread safety. Before calling this method, you must call the Lock method to obtain this key.

EXCEPTIONS

kODErrInvalidLinkKey
The key parameter is not a valid key for this link-source object.
kODErrUnknownUpdateID
The specified update ID is the reserved value kODUnknownUpdate.

SEE ALSO
The ODLinkKey type (page 924).
The ODUpdateID type (page 917).
The ODFrame::ChangeLinkStatus method (page 308).
The ODFrame::ContentUpdated method (page 314).
The ODLinkSource::GetUpdateID method (page 381).
The ODLinkSource::Lock method (page 382).
The ODPart::EmbeddedFrameUpdated method (page 512).
The ODSession::UniqueUpdateID method (page 623).